home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / misc / LibMan1_3.lha / LibraryManager_1.3 / LibMan.doc < prev    next >
Encoding:
Text File  |  1995-03-24  |  9.4 KB  |  210 lines
  1. **************************************************************************
  2. *           Library Manager V1.3 © 1995 Ian Hegerty                      *
  3. **************************************************************************
  4. *   Library Manager is SPACEWARE. See below!                             */
  5. **************************************************************************
  6.  
  7. 1.0 What is Library Manager?
  8. ----------------------------
  9.  
  10.     Library Manager is a commodity designed to control the library files
  11. in your libs: drawer. It can invisibly prevent stupid install scripts from 
  12. overwriting newer versions of libraries by older, whilst allowing the 
  13. replacement of older versions by newer. It can scan inserted disks for
  14. newer versions of libraries than those in your libs: drawer, and 
  15. automatically install them. Library manager also provides a simple way to
  16. show which versions of libraries are on which disks.
  17.  
  18. 1.1 Why write it?
  19. -----------------
  20.  
  21.     Because I was fed up of programs saying 'Could not open library' and 
  22. failing, and then having to search through my disks for the correct version
  23. using 'type opt h' and looking for the ID string, because the VERSION 
  24. command gives incorrect results for disk-based libraries. I started just
  25. write-protecting my libraries, but most install scripts would just fail, 
  26. so I had to do it manually... I'm a lazy soul at heart.
  27.  
  28. 1.1 What do you need to run it?
  29. -------------------------------
  30.  
  31.     WB2.0 and about 20K of free ram. Its probably not much use without a
  32. hard disk.
  33.  
  34. 1.2 How do you use it?
  35. ----------------------
  36.  
  37.     QUICK GUIDE:
  38.  
  39.     Put in in WBStartup and reboot. After booting, press Alt-Shift-F6
  40. to bring up the window. Piss about a bit, and Bob's your uncle.
  41.  
  42.     SLIGHTLY SLOWER GUIDE
  43.  
  44.     Double click to activate it, or copy it to your WBStartup drawer to
  45. automatically start it on boot. Library Manager will then be running in the 
  46. background, and to bring it up either double click on the icon AGAIN, or
  47. press the pop-key Alt Shift F6 (this may be changed later).
  48.  
  49.     The window that pops up is pretty self explanatory. The cycle gadget
  50. at the top selects whether the 'System Libraries' (i.e. those in 'libs:') 
  51. are displayed or those in the ChkDir directory (usually 'df0:libs').
  52. Clicking on a displayed library shows the library id string, if there is
  53. one. Beneath this is a scrollable list of all the libraries, in the form
  54.  'Name Vxx.xx' (i.e Version,Revision). The tag ROM after the name
  55. indicates that the library is in ROM.
  56.  
  57.     Library manager will automatically check the libs drawer of disks 
  58. inserted whilst it is running. If, however, you wish to check another
  59. drawer, click on the string gadget marked 'Check Directory' and type
  60. the directory's name. Alternatively,you can use the GetFile (the little 
  61. picture to the right of the 'Check Directory' gadget) to select a 
  62. directory (not a file!). 
  63.  
  64.     Just beneath this gadget is the 'Pop-up key' gadget. By clicking
  65. here, you can select which key you use to pop-up Library Manager when 
  66. it is hidden. See the Workbench manuals for details of the possible
  67. combinations.
  68.  
  69.     By selecting one of the three 'update' buttons on the right, you can
  70. select whether you want library manager to never update older libraries
  71. with newer ones, to ask if you want a library updated, or to automatically
  72. update libraries. 
  73.  
  74.     Similarly the three buttons on the left determine whether you want 
  75. your libs: files protected against deletion and unauthorised updating
  76. (more often downdating!). No protect does just that,  whilst Auto Protect 
  77. clears the 'd' flag on all libs: libraries so they can't be deleted or 
  78. overwritten. However, setting Auto Protect will cause any install scripts
  79. which try to update or downdate a libs: file to fail, probably before 
  80. doing the useful part of the installation. 
  81.  
  82.     This is where Clever Protect comes in. What it does is to redirect 
  83. any .library files that are being installed to a temporary directory, and 
  84. then compare them to the libs: libraries. Depending on how Update is set, 
  85. it will either automatically update with newer versions (Auto Update), 
  86. while trashing the older, or ask you if you want the newer versions 
  87. installed, or just do nothing. By selecting Clever Protect, you can ensure
  88. that programs will not fail because of old versions of libraries.
  89.  
  90.     Beneath the Protect and Update gadgets lies the 'Ignore Unopenable
  91. Libraries' switch. If this is ticked, any libraries that cannot be opened
  92. will be ignored, rather than Library Manger giving you a warning. This may
  93. happen if Library Manager encounters a WB3.0 library on a WB2.0 Amiga, or
  94. if one one copy of a library can be opened (e.g socket.library from the
  95. AmiTCP distribution), and the library is already open.
  96.  
  97.     Finally, at the very bottom are the four button gadgets. 'Save' saves
  98. the current settings of Library Manager. 'Hide' or the close gadget makes
  99. the program run in the background. 'About' gives the usual credits, and
  100. 'Quit' terminates Library Manager.
  101.  
  102.     As Library Manager is a commodity, it can also be controlled by the
  103. Commodities Exchange program. See the Workbench manual for details.
  104.  
  105. 1.3 Configuring and Tooltypes
  106. -----------------------------
  107.  
  108.     Most of the options of Library Manager can be configured from its
  109. window. Any of the options you can set from this window can be saved
  110. by clicking on the SAVE button. This will also save the position of the
  111. window. Pressing SAVE updates the programs icon, so be warned if you
  112. move the program!
  113.  
  114.     Aside from the standard CX tooltypes, Library Manager also supports:
  115.  
  116.  IGNORE = (YES|NO)            - whether to ignore unopenable libraries
  117.  CHKDIR = <string>            - the default check directory.
  118.  PROTECT = (NONE|AUTO|CLEVER) - see above
  119.  UPDATE = (NONE|PROMPT|AUTO)  - see above
  120.  DELAY =  <number>            - the number of ticks (1/50th of a second)
  121.                                 before LibMan starts reading an inserted
  122.                                 disk. Use this to prevent thrashing with
  123.                                 virus checkers.
  124.  
  125.  XPOS = <number>              -  x position of window
  126.  YPOS = <number>              -  y position of window
  127.  
  128.  FONT = <fontname>            -  use a font other than the default
  129.  FONTSIZE = <number>          -  size of the font
  130.  
  131.  
  132.  
  133. 1.4 Possible problems
  134. ---------------------
  135.  
  136.     Some buggy custom libraries may crash on loading. The only library
  137. I know of which does this is an early version of xprkermit.library. (
  138. the version I now have, V1.112 however, works fine). The only thing Library 
  139. Manager does to libraries is to OpenLibrary() them, which is about the only 
  140. thing you can do to a disk-based library, so don't blame me! Maybe if enough
  141. people ask for it, I will add an exclude function to ignore certain 
  142. libraries.
  143.  
  144.     If a library is already installed in the system memory, it is normally 
  145. extremely difficult to find out the version of another copy of the library
  146. on disk. This is because some libraries link themselves into the system 
  147. library list, and will not replace a newer version in memory. This is the
  148. reason why the VERSION command is almost useless for uncovering library 
  149. versions. If the library is already in memory, VERSION will give you the 
  150. version of the library in memory.
  151.  
  152.     What Library Manager does to get around this is to examine the file
  153. itself. Unfortunately, because self-installing libraries set up their data,
  154. you can't have access to the revision number without OpenLibrary()ing them,
  155. which will just return the version already in memory... If this situation
  156. occurs, Library Manager will try to obtain the version from the ID string
  157. (WARNING - this may not be correct!). Even if this fails, (which will
  158. only happen with badly written libraries, the major Version number is
  159. always available in another area of the file, and in this case Library
  160. Manager displays the version as 'Vxx.??'. Updates are performed
  161. as above, but are based only on the major Version number.
  162.  
  163.  
  164.     In order to Clever Protect, Library Manager traps the Open() and Close()
  165. calls. This causes no problems unless another program does the same 
  166. BEFORE Library Manager, and terminates BEFORE Library Manager. I have not 
  167. found any programs that cause this, and so long as Library Manager is 
  168. started on boot and kept running, this problem should not occur. 
  169.  
  170. 1.5 How can you thank me enough?
  171. --------------------------------
  172.  
  173.     This product is SPACEWARE. If you like it, why not listen to a
  174.  Spaceman 3 album? Recommended is Playing with Fire.
  175.  
  176.     If you want to contact me, here are my details
  177.  
  178.     Ian Hegerty,
  179.     20 Edith Road,
  180.     Maidenhead.
  181.     Berks.
  182.     SL6 5DY.
  183.     ENGLAND.
  184.  
  185.     E-mail:  ihegerty@sina.demon.co.uk
  186.              HEGERTY@rhphv1.ph.rhbnc.ac.uk
  187.  
  188.  
  189.     Any suggestions, bug reports, spare 3.1 roms for a 2000 etc will be
  190.     greatly appreciated!
  191.  
  192.     Special thanks to Keith Butler for suggestions and testing (and making
  193.     me remember that I had written the arlier versions!).
  194.  
  195. 1.6 Copyright and Legal stuff
  196. -----------------------------
  197.  
  198.     This is a full version of a SPACEWARE program. It can be freely copied
  199.     and distributed by private individuals, bulletin boards, and public
  200.     domain distributors on the condition that this file is distributed with
  201.     it, and that only a small fee is charged for copying. Magazines may 
  202.     include the program on disks for a fee equivalent to UKP 50. However
  203.     copyright remains with Ian Hegerty. If they make money out of me, why
  204.     shouldn't I?
  205.  
  206.  
  207.                                Cheers,
  208.  
  209.                             Ian Hegerty.
  210.